home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / quartz / q1073.dms / q1073.adf / IFFTOASC.LHA / Iff2Ascii / iff2ascii.doc < prev    next >
Text File  |  1994-02-20  |  4KB  |  95 lines
  1.             _____  __  __ ___   ___           _ _
  2.            l_   _l/ _l/ _l__ \ / _ \         (_l_)
  3.              l l l l_l l_   ) l l_l l___  ___ _ _
  4.              l l l  _l  _l / /l  _  / __l/ __l l l
  5.             _l l_l l l l  / /_l l l \__ \ (__l l l
  6.            l_____l_l l_l l____l_l l_l___/\___l_l_l
  7.                                              
  8.  
  9.   Matthew Stratfold, Feburary 1984  M.P.Stratfold@open.ac.uk
  10.  
  11. Purpose:
  12. -------
  13. To convert IFF picture images into an ASCII representation. The program
  14. will antialiase the text by selecting the best characters to make the
  15. edge.  Characters are also selected for their density when shading.
  16.  
  17. How to use:
  18. ----------
  19. Start the program from either the workbench or shell in the normal way
  20. once it is loaded click to contine then select the picture you want from
  21. the file requester. (I hate that file requester too.)
  22.  
  23. The picture will load to screen.  Decide what area of the pic you want
  24. to convert and click one of the corners of that area (nothing will be
  25. displayed sorry), then click the other corner to define your area. At
  26. this point a dotted line will be drawn around the area - if you've done
  27. it wrong - start again!
  28.  
  29. You will need to wait for a while (not long) as the conversion takes place.
  30. Then the program exits leaving the text file in the same directory as the
  31. original picture though with the added extension '.txt'.
  32.  
  33. If the area you selected was large then the chances are that the lines
  34. in the ascii file will be too long to be displayed on many viewers - just
  35. choose a smaller font or use DJ's ASCII-View (good program - though I 
  36. couldn't find you real name on the file I got)
  37.  
  38. How it works:
  39. ------------
  40. It's written in AMOS - have a look at the listing.  I know the bounding
  41. box stuff is weak, but the main routine is okay.  The program looks at
  42. pixel blocks of 2x3 pixels and selects a character that best matches that
  43. block.  Consequently the ascii picture will be that much bigger than
  44. the original IFF one.
  45.  
  46. A binary number is worked out from each block - the base10 number from this
  47. is used to fetch the right character from the data array - simple and
  48. fast.
  49.  
  50. Preparation of IFF's:
  51. --------------------
  52. The program assumes that any non background colour is a colour, you can
  53. load colour images but the results won't be much good.  The best thing
  54. to do is load your favourite image processor (eg adpro) and dither a
  55. 2 colour image from that.  Dithered images work well since the routine
  56. selects characters for the density of the dither.
  57.  
  58. Archive:
  59. -------
  60. In the archive is executable, amos program, program text, this doc, and
  61. some examples.  The examples are a dithered picture, and some ascii's.
  62.  
  63. Bugs:
  64. ----
  65. I've been very pushed for time so this isn't as polished or as flexible
  66. as I would like. But it works and it's fairly easy to understand alter
  67. so feel free to improve it - it'd be nice if you can send me the improved
  68. version though :-)
  69.  
  70. For some reason AMOS on my machine sometimes loads IFF's wrong if they
  71. are much smaller that the screen size.  So some IFF brushes won't work.
  72. If this is the case stick your brush.
  73.  
  74.  
  75. Distribution etc:
  76. ----------------
  77. The Conversion Table is inspired by Jorn Barger's alt.ascii-art FAQ
  78. which had the table by Rob Harley(robert@vlsi.cs.caltech.edu) in it.  
  79.  
  80. The program is freely distributable, though keep the docs,source and exe 
  81. together with my name on.  If you make changes then document them and 
  82. send a copy to me.
  83.  
  84. Feel free to include this in any archives and libraries that do not 
  85. charge any money other than amount to cover the cost of media and 
  86. distribution.
  87.  
  88. This program is BeerWare - if you like it go and buy yourself a beer :-)
  89.  
  90. My Address:
  91. ----------
  92. Email: M.P.Stratfold@Open.ac.uk
  93. Snail: IET, The OU, Milton Keynes, MK1 1NG
  94.  
  95.